✅ Deploy Preview for testcontainers-go ready!

Name	Link
🔨 Latest commit	ff0c701
🔍 Latest deploy log	https://app.netlify.com/projects/testcontainers-go/deploys/68e7d94ec792eb0008d0debc
😎 Deploy Preview	https://deploy-preview-3443--testcontainers-go.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Summary by CodeRabbit

• Refactor

  • Simplified container setup using a modular options-based configuration without changing user-facing behavior.

• Bug Fixes

  • Preserved necessary capabilities to prevent potential memory lock issues, improving container stability.
  • Improved startup reliability with a consolidated wait and environment configuration.

• Chores

  • Clarified error messages when starting the Vault container.

Walkthrough

Refactors Vault module to use testcontainers.Run with modular ContainerCustomizer options. Replaces direct ContainerRequest mutations for env, wait strategy, exposed ports, and host config. Updates error messages. Adjusts WithToken and WithInitCommand to return options (WithEnv, WithAdditionalWaitStrategy). Preserves CAP_IPC_LOCK via HostConfigModifier.

Changes

Sequence Diagram(s)

sequenceDiagram
  autonumber
  participant U as Caller
  participant V as vault.Run(...)
  participant TC as testcontainers.Run
  participant D as Docker Engine

  U->>V: Run(ctx, img, opts...)
  Note right of V: Build moduleOpts<br/>- WithExposedPorts<br/>- WithEnv<br/>- WithWaitStrategy<br/>- WithHostConfigModifier (CAP_IPC_LOCK)
  V->>TC: Run(ctx, img, moduleOpts+opts)
  TC->>D: Create & start container
  alt start succeeds
    D-->>TC: Container started
    TC-->>V: Container handle
    V-->>U: Return container
  else error
    D-->>TC: Error
    TC-->>V: Error
    V-->>U: wrap "run vault: %w"
  end

  rect rgba(230,245,255,0.5)
  Note over U,V: Option hooks
  U->>V: WithToken(token)
  V-->>U: returns WithEnv("VAULT_TOKEN"=token)
  U->>V: WithInitCommand(cmd)
  V-->>U: returns WithAdditionalWaitStrategy(wait.ForExec(cmd))
  end

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• chore(pulsar): use Run function #3426 — Similar refactor to option-based testcontainers.Run replacing GenericContainerRequest mutations, including WithEnv/WithWaitStrategy usage.
• chore(rabbitmq)!: use Run function #3428 — Performs the same migration pattern to moduleOpts with Run and updated error handling.
• chore(openfga): use Run function #3421 — Applies identical options-based Run refactor across modules, aligning WithEnv and wait strategy handling.

Poem

I hop through opts with nimble feet,
From rigid reqs to runs so neat.
Env and waits now neatly spun,
A carrot-colored CAP_IPC_LOCK won.
In burrows built with tidy fun—
Vault awakens, job well done! 🥕🐇

Pre-merge checks and finishing touches

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

_{Comment @coderabbitai help to get the list of available commands and usage tips.}